IUCompPString

Compare p-strings using specified 'itl2' resource

short IUCompPString(aStr, bStr, itl2Handle);

Str255 aStr; strings to ...

Str255 bStr; ... compare

Handle itl2Handle; handle to 'itl2' resource

returns -1 if (ab)

IUCompPString compares two high-level language strings for primary and

secondary ordering and determines whether one is greater than, less than, or

equal to another and permits explicit specification of the 'itl2' resource to be

used for string comparison It takes into consideration such international

characteristics as diacritical marks and ligatures. It DOES differentiate

between upper- and lowercase.

aStr and . . .

bStr are the addresses of pascal-style length-prefixed strings to be

compared.

itl2Handle is a handle to the 'itl2' resource to be used for the string

comparison. If this handle is NIL, the routines behaves just like

IUCompString, which does not permit explicit specification of the

handle..

Returns: a signed short; it describes the collation relationship of aStr and

bStr. It is one of:

-1 aStr is less than bStr

0 aStr and bStr are equal

1 aStr is greater than bStr

Notes: The IUCompPString and IUEqualPString functions are available for

high-level languages only.

Referenced by (14):